home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / diskutil / flcat_14.lzh / FLCAT_14.ASC < prev    next >
Encoding:
Text File  |  1993-09-05  |  19.9 KB  |  423 lines
  1.                            The File Catalog
  2.  
  3.                               Version 1.4
  4.                              September 1993
  5.  
  6.                        Written in GFA Basic 3.5e
  7.                            by Randy Hoekstra
  8.  
  9.                 This version may be freely distributed,
  10.            but if you like and use it, please send $10.00 to
  11.             the author to support further development.  See
  12.                           below for details.
  13.  
  14.                     All Commercial Rights Reserved
  15.  
  16.  
  17.      * Changes for Version 1.4 (09/93):
  18.  
  19.      - bug fix - disk name updates in new list after changing it
  20.      - bug fix - generate new list updates disk name
  21.      - change window setup code to be more resolution independent
  22.      - added show file menu command
  23.      - bug fix - deleted folders were not showing up in delta list
  24.      - implemented PRINT function from file dialog
  25.      - added menu commands to select file info to display
  26.      - converted form_dials & objc_draws to work with let em fly
  27.      - implemented GEM windows (4) and some window gadgets
  28.      - bug fix - available drives not being set correctly
  29.      - bug fix - saving new list not resetting saved flag
  30.      - added shift clr/home to go to bottom of list
  31.      - 'add to archive' now checks name and drive letter for a match
  32.      - added set paths command
  33.      - added backup delta list command
  34.  
  35.      See end of document for version history
  36.      ------------------------------------------------------------
  37.  
  38.      
  39.      What is the File Catalog?
  40.      -------------------------          
  41.      The File Catalog is a simple utility that keeps track of the 
  42.      files on a disk or hard drive partition and allows you to 
  43.      monitor changes to your files.  The program reads in all the 
  44.      files on a disk or partition and stores them in a file.  
  45.      Later, a new list can be generated and the old and new lists 
  46.      can be automatically compared to see what has changed.  The 
  47.      'delta' of the old and new file lists will show all files 
  48.      that have been deleted, added, or changed (size or date).  It 
  49.      can not detect files that have been changed without a change 
  50.      in size or change in the date stamp.
  51.      
  52.      FileCat can now also back-up those files that have been added 
  53.      or changed, with a simple menu command.  You select the path 
  54.      that you want back-ups sent to and the either manually select 
  55.      files to copy to the back-up path or select a command to 
  56.      back-up all files added or changed as identified in the delta 
  57.      list.  This allows for very easy and reliable incremental 
  58.      back-ups.
  59.      
  60.      I have been using this program for awhile to help manage hard 
  61.      disk back-ups.  By finding out what has changed since the 
  62.      last back-up, I can decide what files need to be backed up 
  63.      and what files need to be deleted before a tape back-up.  
  64.      With version 1.4, I can now use the delta list to make 
  65.      incremental back-ups more often and not have to worry about 
  66.      losing anything in between full tape back-ups.
  67.  
  68.      Version 1.4 is being released as donation-ware.  If you like 
  69.      and use the program, please send $10.00 to support further 
  70.      development.  Include a floppy disk or $5.00 to receive the 
  71.      latest version, when it is available.
  72.      
  73.      I certainly plan to continue enhancing the program as time 
  74.      permits.  If you have any suggestions for enhancements, new 
  75.      features, or whatever, I would love to hear them.  I would 
  76.      also like to hear about any bugs, and will do my best to 
  77.      correct them as soon as possible.  For any of the above, or 
  78.      to just let me know you're using the program, you can contact 
  79.      me at the following:
  80.      
  81.           Randy Hoekstra
  82.           3414 Norwood Circle
  83.           Richardson, Texas  75082
  84.      
  85.           GEnie:  R.Hoekstra1
  86.      
  87.      
  88.      
  89.      Using The File Catalog:
  90.      -----------------------
  91.      For a quick start, run the program, select the desired drive 
  92.      under the DRIVE menu, and select GENERATE FILE LIST under the 
  93.      DO menu.  This will bring up a list of current files on the 
  94.      selected drive.  The SAVE NEW LIST under the FILE menu should 
  95.      then be used to save the list to the selected drive.  Not 
  96.      much else to do now but go about your normal business of 
  97.      computer using.  After changes have been made to the files on 
  98.      the drive, you can return to The File Catalog, load in the old 
  99.      list (LOAD OLD LIST under FILE), generate a new list (GENERATE 
  100.      FILE LIST under DO), and then see what has changed (DELTA OLD 
  101.      & NEW under DO).  Or, all of the above can be accomplished by
  102.      selecting DO ALL under the DO menu.
  103.      
  104.      Starting with version 1.4, the various file list are all 
  105.      displayed in their own windows.  These windows can be sized 
  106.      and moved independently using standard GEM window techniques.
  107.      The active file list (window) can be selected by clicking on 
  108.      any visable portion of that window or by selecting the 
  109.      appropriate file list from the WINDOW menu.
  110.  
  111.      You can also select BACKUP DELTA LIST from the DO menu and all 
  112.      files in the detla list marked as CHANGED or NEW will be 
  113.      copied to the back-up path (see SET PATHS under FILE menu).  
  114.      The default path is floppy drive A: until set otherwise.
  115.  
  116.      The File Catalog can also be used to search for a file on a 
  117.      given disk or hard drive partition.  Using the SEARCH FOR 
  118.      FILE command under the WINDOW menu, you can enter any 
  119.      character string up to 12 characters in length to search for.  
  120.      The search routine will find any occurrence of the string at 
  121.      any position within the searched text (search for PRG will
  122.      find any file that ends in .PRG or contains PRG somewhere 
  123.      within the filename).
  124.      
  125.      File maintenance can also be performed by generating a new
  126.      file list and then selecting (clicking with left mouse
  127.      button) any displayed file to copy, move, rename, or delete
  128.      the file.  A dialog will be presented with the options and
  129.      and a chance to cancel the command.
  130.           
  131.      The program is very simple to use and should be fairly 
  132.      intuitive from the Menus.  The following brief overview of 
  133.      the menu commands should get you going.
  134.  
  135.      
  136.      FILE
  137.      ====
  138.      
  139.      Load Old List ^L:  Once a file list has been generated and saved 
  140.      -----------------  to disk, this command can be used to load 
  141.      that list back into memory.  The old file list must be loaded 
  142.      before a delta can done between the old and new.  The old 
  143.      file list will be loaded from the path specified in the SET 
  144.      PATHS dialog (see SET PATHS command below).
  145.      
  146.      Save New List ^N:  This command is used to save the current 
  147.      -----------------  (new) file list to disk.  The command can 
  148.      only be selected after the GENERATE FILE LIST command is used 
  149.      to create a new file list.  You must initially generate a 
  150.      file list and save it to disk in order to have a list of 
  151.      files that can be compared to a new list at a latter date.
  152.      The new list will be saved to the path specified in the SET 
  153.      PATHS dialog (see SET PATHS command below).
  154.  
  155.      Append to Archive:  Selecting this command will bring up a
  156.      ------------------  file selector and allow you to choose an
  157.      existing archive file or type in a new file name.  If it is
  158.      a new file, the current new file list in memory will be saved
  159.      to this file.  If it is an existing archive file, that file
  160.      will be searched to see if the disk name and drive letter of 
  161.      the new file list in memory already exists in the archive 
  162.      file.  If no match is found, then the new file list will be 
  163.      added to the end of the archive file.  If a disk name match 
  164.      is found, you will be given the option to replace the 
  165.      existing file list in the archive file, skip the existing 
  166.      file list and continue searching, or cancel the command.  If 
  167.      continue is selected, the search will resume until another 
  168.      match is found or the end of file is reached.  If the end of 
  169.      file is reached, the new file list will be added to the end 
  170.      of the archive file. This command can only be used when there 
  171.      is a new file list in memory.  If there is not, a dialog will 
  172.      be presented with an indication that the command can not be 
  173.      performed.
  174.  
  175.      Show File:  This command will bring up a file selector and 
  176.      ----------  allow you to choose a file to display in the Show 
  177.      File window.
  178.  
  179.      Note:  The file is not checked for ASCII characters, so it is 
  180.      possible to corrupt the Show File window if non-ASCII chars
  181.      are present in the file being displayed.
  182.  
  183.      Delete File:  This command can be used to delete any file 
  184.      ------------  using the standard file selector to choose the 
  185.      file to be deleted.  You will be prompted to verify the 
  186.      delete before it is performed.
  187.  
  188.      Set Paths:  This command will bring up a dialog allowing you 
  189.      ----------  to set the paths for the file lists to be 
  190.      saved/loaded from. The default is the root directory of the 
  191.      drive selected, but it can be set to any path desired.
  192.  
  193.      At the bottom of the SET PATHS dialog, is a line for the 
  194.      back-up path.  Enter the desired path to be used to copy 
  195.      files to when a back-up operation is performed either by 
  196.      clicking on a file name with the control key pressed or by 
  197.      selecting the BACKUP DELTA LIST command from the DO menu 
  198.      (after generating a delta list).
  199.      
  200.      All paths can be set by clicking on the path line and setting 
  201.      the path from the file selector.
  202.      
  203.      Save Configuration:  Use this command to save the current 
  204.      -------------------  configuration to disk.  The data will be 
  205.      saved in file FILECAT.CFG in the same directory as the 
  206.      program.  The data saved in the configuration file includes 
  207.      the paths, view options, and GEM window positions and size. 
  208.      The configuration data is automatically loaded in the next 
  209.      time the program is run.
  210.      
  211.      Page Set Up:  This command has not yet been implemented.
  212.      ------------
  213.      
  214.      Print Window:  This command will print only the visable   
  215.      -------------  contents of the currently selected window. 
  216.      
  217.      Print Entire List:  This command will print the entire list 
  218.      ------------------  of files in the currently selected window.
  219.      
  220.      Quit ^Q:  This will terminate execution of the program after 
  221.      --------  prompting you to save the new file list if it has been 
  222.      generated but not saved.
  223.      
  224.      
  225.      DRIVE
  226.      =====
  227.  
  228.      This menu list is used to select the drive on which all 
  229.      other operations will be performed.  When a new drive is 
  230.      selected, the current file lists are cleared from memory.
  231.      
  232.      
  233.      DO
  234.      ==
  235.      
  236.      Generate File List ^G:  This command reads in all the files on 
  237.      ----------------------  the currently selected drive.  The file 
  238.      list generated must be saved to disk using the SAVE NEW LIST 
  239.      command if it is to be used at a latter date as the old list.
  240.  
  241.      Delta Old & New ^D:  This command compares the old and new file 
  242.      -------------------  lists and generates a list of changes.  
  243.      Changes include files added, files deleted, files changed, 
  244.      folders added, and folders deleted.  In order to perform this 
  245.      delta, an old file list must be loaded and a new file list 
  246.      generated.  This command will also copy any file comments
  247.      from the old file list to the new file list, where they can
  248.      be edited or saved with the new file list.
  249.      
  250.      Do All ^A:  This command will perform the three most common 
  251.      ----------  commands used in The File Catalog (Load Old List,
  252.      Generate File List, and Delta Old & New) all in one.  See
  253.      the description of these three commands for details on what
  254.      each one does.  Upon completion, the delta list will be
  255.      displayed.
  256.  
  257.      BackUp Delta List:  This command will search through the 
  258.      ------------------  delta list and all files marked as NEW 
  259.      or CHANGED will be copied to the path specified as the back-
  260.      up path in the SET PATHS dialog.
  261.      
  262.      If the file to be copied already exists in the destination 
  263.      path, you will be presented with an alert saying 'File 
  264.      Already Exists. Overwrite?' allowing you to either copy the 
  265.      file, skip that file, or copy the file and prevent the 'File 
  266.      Already Exists' alert from appearing again during that back-
  267.      up session (YES, NO, ASK NOT).  If ASK NOT is selected, the 
  268.      remaining files will be copied without stopping even if the 
  269.      files already exist in the destination path.
  270.  
  271.      Search for File ^S:  This command will search any list for a
  272.      -------------------  string of characters up to 12 chars in
  273.      length. The search routine will find any occurrence of the 
  274.      string at any position within the searched text (search for 
  275.      PRG will find any file that ends in .PRG or contains PRG 
  276.      somewhere within the filename).  The search will begin from 
  277.      the current top line in the window and the first occurrence 
  278.      found will then become the top of the displayed list.
  279.      
  280.      Search Again ^R:  Once the above command has been executed,
  281.      ----------------  this command will be available to search for
  282.      the next occurrence of the search string starting at the last
  283.      found position.  This command can be used to search for
  284.      multiple occurrences through the entire file.
  285.  
  286.      
  287.      VIEW
  288.      ====
  289.      
  290.      File Size, File Time, File Date, Comment:
  291.      -----------------------------------------  
  292.      These commands toggle on and off the display of the 
  293.      corresponding field in the currently active window.  A check 
  294.      mark next to the command indicates that field is to be 
  295.      displayed.
  296.      
  297.      Each window can be set up with it's own unique display 
  298.      configuration using the commands in the VIEW menu.
  299.  
  300.           
  301.      WINDOW
  302.      ======
  303.  
  304.      Old File List, New File List, Delta List, Show File:
  305.      ----------------------------------------------------     
  306.      Use this menu to select the file list to display in the 
  307.      widow.  The active display will be shown with a check mark to 
  308.      the left of the file list name.  The window can display 
  309.      either the old file list, new file list, the delta list,
  310.      or the show file.
  311.  
  312.      
  313.      KEY COMMANDS:
  314.      ~~~~~~~~~~~~~
  315.      In addition to the keyboard equivalents for the above menu 
  316.      commands, the following key commands are available.
  317.      
  318.      - UP/DOWN ARROW: Use the arrow keys to scroll the display.
  319.      - SHIFT+UP/DOWN ARROW: This will scroll a page at a time.
  320.      - RIGHT/LEFT ARROW:  This will cause the display to jump to
  321.        the next/previous sub-directory entry, respectively.
  322.      - CLR/HOME:  This will move the display to the top of the
  323.        current file list.
  324.      - SHIFT CLR/HOME:  This will move the display to the bottom
  325.        of the current file list.
  326.      - CONTROL + MOUSE CLICK:  Clicking on a filename while
  327.        pressing the control key will cause that file to be copied
  328.        to the back-up path set in the SET PATHS dialog.
  329.     
  330.      
  331.      EXTRAS:
  332.      ~~~~~~~
  333.      - Any file in any list displayed on the screen can be 
  334.      selected with the left mouse button to bring up a file dialog 
  335.      allowing the file to be copied, moved, renamed, deleted,
  336.      printed, or shown in the show file window.  An alert will 
  337.      indicate if a selected file does not exist on the drive (when 
  338.      choosing from the old file list or the delta list) and the 
  339.      file dialog will not be presented.
  340.      - The disk name at the top of the list can be selected to 
  341.      bring up a dialog allowing the disk name to be changed.  This 
  342.      will use the standard disk name format, or if you use NEODESK 
  343.      it will use the 21 character format used by NEODESK. 
  344.      (NEODESK is a trademark of Gribnif Software)
  345.  
  346.      
  347.      That's all there is to it.  Like I said, it's pretty simple.  
  348.      I find it useful for general file maintenance on my hard 
  349.      drive and maybe you will too.  If you have any questions, 
  350.      suggestions, or whatever, please contact me at the addresses 
  351.      above.  Thanks for allowing me to occupy your disk space.
  352.  
  353.      
  354.      In the PipeLine:
  355.      ~~~~~~~~~~~~~~~~
  356.      I have some other ideas rumbling around in the noggin, so I
  357.      will probably have a next version before too long.  What I 
  358.      don't know is which idea to implement first.  If you have a 
  359.      preference (or some ideas of your own), let me know and I 
  360.      will probably do that one first.  My current list of ideas is 
  361.      as follows:
  362.      
  363.        - Disk info command to show number of files and bytes.
  364.        - Directory Tree display to show only the folders.
  365.        - Options to display only the file info desired (size,
  366.          date, etc) and to sort by size, date, etc.
  367.        - Implement the file info button in the file dialog and
  368.          allow changing the file attributes (hidden file, archive
  369.          bit, etc) from the file info dialog.
  370.        - Implement some type of compression for the new file list
  371.          saved to disk.
  372.  
  373.      
  374.      Version History
  375.      ~~~~~~~~~~~~~~~
  376.      
  377.      * Changes for Version 1.3 (05/93):
  378.        - Added Disk Name to top of file list.  Disk name can be
  379.          clicked on to change the name.
  380.        - Added Copy, Move, and Show to a new file dialog with
  381.          Rename and Delete when a file is selected from the main
  382.          file list window.
  383.        - Commands from the file dialog will automatically update
  384.          the new file list in memory (ie when a file is deleted
  385.          it's entry will be removed from the new file list that
  386.          is currently in memory).
  387.        - Added the ability to have a 30 character comment line
  388.          following the file info.  This comment can be edited by
  389.          selecting a button from the file dialog.  Comments are
  390.          transferred from the old file list to the new file list
  391.          when a delta is run.
  392.        - Added menu command to add new file list to an archive
  393.          file containing multiple file lists from various disks.
  394.          If disk name is found in the archive file, you will have
  395.          the option to replace the existing file list or add the
  396.          file list to the end of file.
  397.        - Added key commands to jump to the next/previous sub-
  398.          directory entry in the currently displayed list.
  399.          (right/left arrow respectively)
  400.        - Optimized the way the new file list is read into memory, 
  401.          speeding up the operation and reducing the amount of disk
  402.          accessing required.
  403.      * Changes for Version 1.2 (02/93):
  404.        - Fixed a bug seen when selecting list to display (Window)
  405.        - Various code clean-up and enhancement
  406.        - Added a point and click to RENAME/DELETE file.  Any
  407.          filename displayed on the screen can be clicked on to
  408.          bring up a RENAME/DELETE Alert.  An alert will indicate
  409.          if a selected file does not exist on the drive (when
  410.          choosing from the old file list or the delta list) and
  411.          the RENAME/DELETE alert will not be presented.
  412.        - Added a SEARCH FOR FILE command to allow searching of
  413.          any list for a given string of characters.
  414.        - Added a DO ALL command that will load the old list, 
  415.          generate a new list, and perform a delta all in one.
  416.        - Added keyboard equivalents for nearly all menu commands.
  417.      * Changes for Version 1.1 (12/92):
  418.        - Window redraws are handled correctly with ACCs.
  419.        - The selected drive is initialized to the drive the 
  420.          program was run from instead of drive A.
  421.        - Drives that do not exist are disabled from the menu.
  422.  
  423.